Draft SelectPlane/sv

Shape2DView

SetStyle

Draft

Description

introduced in version 1.0: For each 3D view a separate working plane is stored.

The button in the Draft Tray changes depending on the current working plane. introduced in version 1.0: If the working plane is not set to Auto an asterisk (*) is appended to the button label if the origin of the working plane does not match the global origin.

Shapes created on different working planes

Usage with pre-selection

1. Do one of the following:
   • Select a single object. The following objects are supported:
     • Draft WorkingPlaneProxies: the VyView Data (the camera position) and the VyVisibility Map (the saved visibility of objects) of the working plane proxy are also restored.
     • Arch Axes (introduced in version 1.0)
     • Arch AxisSystems (introduced in version 1.0)
     • Arch BuildingParts
     • Arch SectionPlanes
     • Std Parts: to avoid selecting subelements it is advisable to select these in the Tree view.
     • Non-solid objects that consist of a single flat face or a single curved edge, or (introduced in version 1.0) that have three or more vertices.
     • Solid objects or objects without a shape that have a DataPlacement property. (introduced in version 1.0)
   • Select one or more subelements. You can select:
     • A flat face.
     • A curved edge.
     • Three vertices.
     • An edge and a vertex, or two edges. The combined vertices must define a plane. (introduced in version 1.0)
2. There are several ways to invoke the command:
   • Press the button in the Draft Tray.
   • Draft: Select the Utilities → Select plane option from the menu, or from the Tree view or 3D view context menu.
   • Draft: Use the keyboard shortcut: W then P.
3. The working plane and the button in the Draft Tray are updated.

Usage with post-selection

1. Invoke the command as explained above.
2. The Working plane setup task panel opens. See Options for more information.
3. Do one of the following:
   • Select a single object. See the previous paragraph.
   • Select one or more subelements. See the previous paragraph.
4. Click anywhere in the 3D view to confirm the selection and finish the command.
5. The working plane and the button in the Draft Tray are updated.

Usage with presets

1. Invoke the command as explained above.
2. The Working plane setup task panel opens. See Options for more information.
3. Press any of the buttons to finish the command.
4. The working plane and the button in the Draft Tray are updated.

Options

• Press the Top (XY) button to align the working plane with the XY plane of the global coordinate system.
• Press the Front (XZ) button to align the working plane with the XZ plane of the global coordinate system.
• Press the Side (YZ) button to align the working plane with the YZ plane of the global coordinate system.
• Press the Align to view button to align the working plane with the current 3D view. If the Center plane on view checkbox is not checked the working plane origin will match the origin of the global coordinate system, else it will match the center of the current 3D view.
• Press the Automatic button to set the working plane to Auto. A working plane set to Auto will automatically align with the current 3D view whenever a Draft or BIM command requiring point input is started. This is equivalent to pressing the Align to view button before using the command. Additionally the working plane will align to planar faces that have been selected before starting the command, or when points on planar faces are picked during the command.
• The Offset defines the perpendicular distance between the calculated plane and the actual working plane.
• Check the Center plane on view checkbox to put the origin of the working plane in the center of to the current 3D view. This option can be useful in combination with the Align to view button.
• Select a vertex in the 3D view and press the Move working plane button to move the working plane so that its origin matches the position of the selected vertex.
• The Grid color button allows to quickly change the color of the grid. introduced in version 1.0
• The Grid spacing defines the distance between grid lines.
• The Major lines every value determines where major grid lines are drawn. Major grid lines are slightly thicker than minor grid lines. For example if the grid spacing is 0.5 m and there is a main line every 10 squares, such a line will occur every 5 m.
• The Grid size value determines the number of squares in the X and Y direction of the grid.
• The Snapping radius is the maximum distance at which Draft Snap Grid detects the intersections of grid lines.
• Press the Center view button to align the 3D view with the current working plane.
• Press the Previous button to reset the working plane to its previous position.
• Press the Next button to reset the working plane to its next position. introduced in version 1.0
• Press Esc or the Close button to abort the command.

Notes

• It can be useful to align the 3D view with the selected Draft working plane. For example after switching the working plane to Front you may want to switch to the Front view as well.
• The grid can be toggled with the Draft ToggleGrid command.
• By double-clicking Draft WorkingPlaneProxies in the Tree view you can quickly switch between working planes.

Preferences

See also: Preferences Editor and Draft Preferences.

• The grid settings in the task panel as well as several other grid settings are available as preferences: Edit → Preferences... → Draft → Grid and snapping.
• The Snapping radius can also be changed on-the-fly (see Draft Snap) or by changing: Tools → Edit parameters... → BaseApp → Preferences → Mod → Draft → snapRange.

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

introduced in version 1.0:

The WorkingPlane module offers two classes to create working plane objects: the PlaneBase class and the PlaneGui class. The second class inherits from the first. Objects of the PlaneGui class interact with the GUI (the Draft Tray button), the 3D view and the grid. PlaneBase objects do not.

Use the get_working_plane() method of the WorkingPlane module to get an instance of the PlaneGui class linked to the current 3D view. The method either returns the existing working plane linked to the view or creates a new working plane if required.

import FreeCAD as App
import WorkingPlane

wp = WorkingPlane.get_working_plane()

origin = App.Vector(0, 0, 0)
normal = App.Vector(1, 1, 1).normalize()
offset = 17
wp.align_to_point_and_axis(origin, normal, offset)

point = App.Vector(10, 15, 2)
projection = wp.project_point(point)
print(projection)

The PlaneBase class can be used to create working planes independent of the GUI:

import WorkingPlane

wp = WorkingPlane.PlaneBase()

Shape2DView

SetStyle

Draft

Draft

• Drafting: Line, Polyline, Fillet, Arc, Arc by 3 points, Circle, Ellipse, Rectangle, Polygon, B-spline, Cubic Bézier curve, Bézier curve, Point, Facebinder, ShapeString, Hatch
• Annotation: Text, Dimension, Label, Annotation styles, Annotation scale
• Modification: Move, Rotate, Scale, Mirror, Offset, Trimex, Stretch, Clone, Array, Polar array, Circular array, Path array, Path link array, Point array, Point link array, Edit, Subelement highlight, Join, Split, Upgrade, Downgrade, Wire to B-spline, Draft to sketch, Set slope, Flip dimension, Shape 2D view

---

• Draft Tray: Select plane, Set style, Toggle construction mode, AutoGroup
• Snapping: Snap lock, Snap endpoint, Snap midpoint, Snap center, Snap angle, Snap intersection, Snap perpendicular, Snap extension, Snap parallel, Snap special, Snap near, Snap ortho, Snap grid, Snap working plane, Snap dimensions, Toggle grid

---

• Miscellaneous: Apply current style, Layer, Manage layers, Add a new named group, Move to group, Select group, Add to construction group, Toggle normal/wireframe display, Create working plane proxy, Heal, Show snap toolbar
• Additional: Constraining, Pattern, Preferences, Import Export Preferences, DXF/DWG, SVG, OCA, DAT
• Context menu:
  • Layer container: Merge layer duplicates, Add new layer
  • Layer: Activate this layer, Select layer contents
  • Text: Open hyperlinks
  • Wire: Flatten
  • Working plane proxy: Write camera position, Write objects state

User documentation

• Getting started
• Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
• Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate

---

• Help: Tutorials, Video tutorials
• Workbenches: Std Base, Assembly, BIM, CAM, Draft, FEM, Inspection, Material, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework

---

• Addons: Addon Manager, External workbenches, Scripting and macros

---

• Hubs: User hub, Power users hub, Developer hub